CouchDB একটি RESTful API প্রদান করে, যার মাধ্যমে HTTP প্রোটোকল ব্যবহার করে ডেটাবেস এবং ডকুমেন্ট তৈরি করা যায়। এই API-র মাধ্যমে আপনি HTTP রিকুয়েস্ট পাঠিয়ে ডেটাবেস পরিচালনা করতে পারেন, যেমন নতুন ডেটাবেস তৈরি, ডকুমেন্ট তৈরি, আপডেট এবং ডিলিট করা।
1. ডেটাবেস তৈরি করা
CouchDB API ব্যবহার করে নতুন ডেটাবেস তৈরি করা খুবই সহজ। একটি HTTP PUT রিকুয়েস্ট পাঠিয়ে নতুন ডেটাবেস তৈরি করা হয়।
এটা কিভাবে করবেন:
- URL:
http://<server_ip>:<port>/<db_name> - HTTP Method:
PUT - প্রতিক্রিয়া (Response): যদি সফল হয়, তাহলে 201 HTTP স্ট্যাটাস কোড পাওয়া যাবে।
উদাহরণ:
ধরা যাক আপনি একটি নতুন ডেটাবেস তৈরি করতে চান যার নাম mydatabase।
curl -X PUT http://127.0.0.1:5984/mydatabase
এটি আপনার CouchDB সার্ভারে নতুন ডেটাবেস mydatabase তৈরি করবে। যদি সফল হয়, আপনি এই ধরনের একটি প্রতিক্রিয়া পাবেন:
{
"ok": true
}
2. ডকুমেন্ট তৈরি করা
CouchDB ডকুমেন্ট তৈরি করার জন্য POST রিকুয়েস্ট ব্যবহার করা হয়। একটি ডকুমেন্ট JSON ফরম্যাটে তৈরি এবং ডেটাবেসে ইনসার্ট করা হয়।
এটা কিভাবে করবেন:
- URL:
http://<server_ip>:<port>/<db_name> - HTTP Method:
POST - ডেটা: ডকুমেন্টের জন্য JSON ডেটা।
- প্রতিক্রিয়া (Response): নতুন ডকুমেন্টের _id এবং _rev সহ প্রতিক্রিয়া।
উদাহরণ:
ধরা যাক আপনি mydatabase ডেটাবেসে একটি নতুন ডকুমেন্ট তৈরি করতে চান, এবং ডকুমেন্টের মধ্যে একটি নাম এবং বয়স থাকবে।
curl -X POST http://127.0.0.1:5984/mydatabase -H "Content-Type: application/json" -d '{
"name": "John Doe",
"age": 30
}'
এটি একটি নতুন ডকুমেন্ট তৈরি করবে, এবং আপনি এই ধরনের প্রতিক্রিয়া পাবেন:
{
"id": "some_unique_id",
"rev": "1-xxxxxxx"
}
এখানে id ডকুমেন্টের ইউনিক আইডি এবং rev ডকুমেন্টের সংস্করণ।
3. ডকুমেন্টে ডেটা আপডেট করা
CouchDB ডকুমেন্ট আপডেট করতে, প্রথমে সংশ্লিষ্ট ডকুমেন্টের _id এবং _rev প্রয়োজন হয়। এই তথ্য ব্যবহার করে আপনি PUT রিকুয়েস্ট পাঠিয়ে ডকুমেন্টের ডেটা আপডেট করতে পারেন।
এটা কিভাবে করবেন:
- URL:
http://<server_ip>:<port>/<db_name>/<doc_id> - HTTP Method:
PUT - ডেটা: আপডেট হওয়া JSON ডেটা।
- প্রতিক্রিয়া (Response): আপডেট করা ডকুমেন্টের _rev সহ প্রতিক্রিয়া।
উদাহরণ:
ধরা যাক আপনার mydatabase ডেটাবেসে একটি ডকুমেন্ট রয়েছে যার _id some_unique_id এবং _rev 1-xxxxxxx। আপনি ডকুমেন্টের নাম এবং বয়স আপডেট করতে চান।
curl -X PUT http://127.0.0.1:5984/mydatabase/some_unique_id -H "Content-Type: application/json" -d '{
"name": "John Doe",
"age": 31,
"_rev": "1-xxxxxxx"
}'
এটি ডকুমেন্টের age আপডেট করবে এবং নতুন _rev প্রদান করবে।
4. ডকুমেন্ট মুছে ফেলা
CouchDB ডকুমেন্ট মুছে ফেলতে হলে, প্রথমে সংশ্লিষ্ট ডকুমেন্টের _id এবং _rev এর প্রয়োজন হয়। এরপর DELETE রিকুয়েস্ট পাঠিয়ে ডকুমেন্ট মুছে ফেলা হয়।
এটা কিভাবে করবেন:
- URL:
http://<server_ip>:<port>/<db_name>/<doc_id> - HTTP Method:
DELETE - প্রতিক্রিয়া (Response): মুছে ফেলা ডকুমেন্টের _rev সহ প্রতিক্রিয়া।
উদাহরণ:
ধরা যাক আপনি mydatabase ডেটাবেসের একটি ডকুমেন্ট মুছে ফেলতে চান, যার _id some_unique_id এবং _rev 2-yyyyyy।
curl -X DELETE http://127.0.0.1:5984/mydatabase/some_unique_id?rev=2-yyyyyy
এটি ডকুমেন্টটি মুছে ফেলবে এবং সফল হলে নিচের মতো একটি প্রতিক্রিয়া পাবেন:
{
"ok": true
}
সারসংক্ষেপ
CouchDB এর HTTP API একটি শক্তিশালী উপায় যা ডেটাবেস এবং ডকুমেন্টের পরিচালনা, যেমন তৈরি, আপডেট, ডিলিট ইত্যাদি কার্যক্রমকে সহজ করে। HTTP রিকুয়েস্টের মাধ্যমে, আপনি CouchDB এর সাথে যোগাযোগ করতে পারেন এবং JSON ডেটার মাধ্যমে ডেটাবেসের তথ্য পরিচালনা করতে পারেন। RESTful API ব্যবহারের মাধ্যমে এটি ডেভেলপারদের জন্য একটি অত্যন্ত নমনীয় এবং স্কেলেবল সমাধান প্রদান করে।
